LED Bar Tool - Dynamic Configuration of ActiveX Properties

CygNet Studio > Using CygNet Studio Tools and Controls > LED Bar Tool > Dynamic Configuration of ActiveX Properties

LED Bar Tool - Dynamic Configuration of ActiveX Properties

The [ActiveX] property on the Normal page provides a method for dynamic configuration of some of this tool's ActiveX properties (ActiveX page). This may be desirable in a templated environment where you want the configuration of the object to reflect the individual facilities.

For example, the PositionMin and PositionMax property values can be set to 0 and 100 on the ActiveX page. This static scale will be shown regardless of the facility for which the screen is showing data. Or, using the [ActiveX] property, values can be based on the Minimum Setpoint and Maximum Setpoint properties in the point configuration record of the object’s primary point. If the point configuration record contains setpoints of 50 and 250, the scale will show as 50 to 250. If the setpoints are 0 to 100, the scale will show as 0 to 100.

The table below lists the ActiveX Properties that can be dynamically configured, possible sources for the value, the properties of the source that can be applied, and where the property of the source is stored.

ActiveX Property	Description	Source	Source Property (Display Item)	Property Storage Location
CurrentMax	Specifies the maximum value reached by the Position property. It is reset each time the Position value is greater than the CurrentMax value. The only way to access the value is programmatically (i.e., using script).	Any point	Value	Real-time record
CurrentMin	Specifies the minimum value reached by the Position property. It is reset each time the Position value is less than the CurrentMin value. The only way to access the value is programmatically (i.e., using script).	Any point	Value	Real-time record
PositionMax	Specifies the upper limit of the indicator level. Default is 100.	Any point	Maximum Setpoint Value	Point configuration record (Analog page) Real-time record
PositionMin	Specifies the lower limit of the indicator level. Default is 0.	Any point	Minimum Setpoint Value	Point configuration record (Analog page) Real-time record
SectionColor1	Specifies the color of Section 1. Default is green (RGB 0.128.0). Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'	This tool's object	Options include: Low Alarm Color Low Warning Color Normal Color High Warning Color High Alarm Color Low OOR Color High OOR Color Unreliable Color	Based on the [CustomStateColors] of the object.
SectionColor2	Specifies the color of Section 2. Default is yellow (RGB 255.255.0). Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'
SectionColor3	Specifies the color of Section 3. Default is red (RGB 255.0.0). Note: In script, you can set this and other color properties using the VBScript function 'control.somecolor = RGB (255,0,0).'
SectionEnd1	Specifies the end value for Section 1. Default is 50.	Any point	Options include: Low Alarm Value Law Warning Value Normal Value High Warning Value High Alarm Value Low Out-of-Range Value High Out-of-Range Value	Point configuration record (Analog page)
SectionEnd2	Specifies the end value for Section 2. Default is 75.	Any point		Point configuration record (Analog page)

The CurrentMax, CurrentMin, PositionMax, PositionMin, and SectionEnd can be based on properties of the object’s primary point or any point in your CygNet domain. If a point identifier is not specified, the primary point is used.

To Set Up Dynamic Configuration of ActiveX Properties

Show the Property Sheet for the object.
On the Normal page of the object’s Property Sheet, double-click [ActiveX] property to show the ActiveX Property Configurations box.
Add an ActiveX property to the ActiveX Property box:

Click the Add button.
Select one or more properties from the list and click OK.

Configure each property in the list:

Click on the property in the ActiveX Property box.
In the Display Item box, select the item on which to base the value of the ActiveX property. If you are configuring a SectionColor property, indicate the desired Color Mode.
In the CygNet Tag section, select the identifier of the point from which the value will be obtained. Leave the fields blank to use the object’s primary point.

Click OK.